Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Dialog Box-Related Resources

The Extended Item List Resource

Figure 3-21 shows the format of the compiled extended item resource, gxExtendedDITLType.

Figure 3-21 Extended item list resource

The compiled version of this resource contains the following elements:

• Item count - 1. This is the number of items in the resource, less 1.
• A variable number of items.

The format of each item depends on its type, as defined below.

xdtlRadioButtons	Radio buttons
xdtlCheckBox	Checkbox
xdtlEditTextInteger	Integer-format editable text
xdtlEditTextReal	Real-format editable text
xdtlEditTextString	String-format editable text
xdtlPopup	Pop-up menu

The compiled version of an item for a group of radio buttons is shown in Figure 3-22.

Figure 3-22 Radio button items

It contains the following elements:

• Key. The key specifies the kind of item. It is always xdtlRadioButtons.
• Collection tag ID. The collection tag specifies the creator of the collection item, such as gxPrintingTagID for items provided by QuickDraw GX in the job, format, and paper-type collections.
• Collection item ID. The item ID specifies the collection item ID, such as 'incf' for the level of fonts to include.
• Offset. The offset specifies the start of storage for the data. It is the number of bytes into the collection item.
• Count. The count specifies the number of radio buttons in this list. Because there is 1 byte per button in the collection item, the count also specifies the size for the group of buttons in the collection item.
• Item number. The item number specifies the item list's item that corresponds to this radio button. There is one item per button.

The compiled version of an item for both a checkbox or pop-up menu is shown in
Figure 3-23.

Figure 3-23 Checkbox and pop-up menu items

It contains the following elements:

• Key. The key specifies the kind of item. It is always xdtlCheckBox for checkboxes and xdtlPopup for pop-up menus.
• Collection tag ID. The collection tag specifies the creator of the collection item, such as gxPrintingTagID for items provided by QuickDraw GX in the job, format, and paper-type collections.
• Collection item ID. The item ID specifies the collection item ID, such as 'dest' for whether to print to a file.
• Offset. The offset specifies the start of storage for the data. It is the number of bytes into the collection item.
• Item number. The item number specifies the item list's item that corresponds to this checkbox or pop-up menu.
• Fill. The fill is 1 byte.

The compiled version of an item for both integer or real editable text is shown in
Figure 3-24.

Figure 3-24 Integer and real edit text items

It contains the following elements:

• Key. The key specifies the kind of item. It is always xdtlEditTextInteger for integers and xdtlEditTextReal for real numbers.
• Collection tag ID. The collection tag specifies the creator of the collection item, such as gxPrintingTagID for items provided by QuickDraw GX in the job, format, and paper-type collections.
• Collection item ID. The item ID specifies the collection item ID, such as 'copy' for the number of copies.
• Offset. The offset specifies the start of storage for the data. It is the number of bytes into the collection item.
• Item number. The item number specifies the item list's item that corresponds to the editable text item.
• Select. This element specifies whether or not to highlight the text. If its value is 0, the text is not highlighted. If its value is 1, the text is highlighted.
• Lower bounds. This is a Pascal string that contains an optional sign (plus or minus), digits, and for real numbers, an optional decimal point before the fractional part of the number. If the string is nil, no lower bounds is specified.
• Upper bounds. This is a Pascal string that contains an optional sign (plus or minus), digits, and for real numbers, an optional decimal point before the fractional part of the number. If the string is nil, no upper bounds is specified.

The compiled version of an item for string editable text is shown in Figure 3-25.

Figure 3-25 String editable text items

It contains the following elements:

• Key. The key specifies the kind of item. It is always xdtlEditTextString.
• Collection tag ID. The collection tag specifies the creator of the collection item, such as gxPrintingTagID for items provided by QuickDraw GX in the job, format, and paper-type collections.
• Item ID. The item ID specifies the collection item ID, such as 'incf' for the level of fonts to include.
• Offset. The offset specifies the start of storage for the data. It is the number of bytes into the collection item.
• Item number. The item number specifies the item list's item that corresponds to the editable text item.
• Select. This element specifies whether or not to highlight the text. If its value is 0, the text is not highlighted. If its value is 1, the text is highlighted.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help